home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / pibt3doc.arc / README.DOC < prev   
Text File  |  1985-10-08  |  7KB  |  211 lines
  1. INTRODUCTION TO PIBTERM v3.0
  2. ============================
  3.  
  4. This archive contains a program called PibTerm which provides
  5. a terminal emulation and host communications facility.
  6. This is version 3.0 of Pibterm, released October 7, 1985.
  7.  
  8. Features of PibTerm version 3.0 include:
  9.  
  10.    1.  Several different terminal emulation methods:
  11.  
  12.           -- DEC VT52
  13.           -- DEC VT100 (large subset)
  14.           -- BBS ANSI  (ANSI.SYS color graphics and music)
  15.           -- Dumb glass TTY
  16.           -- Dumb glass TTY in split-screen mode
  17.  
  18.    2.  The ability to act as a host program (mini BBS).
  19.  
  20.    3.  Ring buffered, interrupt driven, serial I/O.
  21.  
  22.    4.  A number of popular file transfer methods:
  23.  
  24.           -- Xmodem Checksum and CRC
  25.           -- Modem7 batch with either Checksum or Crc
  26.           -- Ymodem batch or single file
  27.           -- Telink
  28.           -- Kermit
  29.           -- CompuServe "B" Protocol
  30.           -- Ascii with XON/XOFF
  31.           -- Autodownload Xmodem for Bob Mahoney's EXEC PC BBS.
  32.  
  33.    5.  Telephone dialing directory.
  34.  
  35.    6.  Session logging/capture to printer and/or disk.
  36.  
  37.    7.  On-screen editing (block mode) for use with mainframes.
  38.  
  39.    8.  Menu-driven commands.
  40.  
  41.    9.  Macro-key definition, with sufficient capability to
  42.        provide auto-logon scripts.
  43.  
  44.   10.  Escapes to the operating system (and return from DOS)
  45.        within a PibTerm session.
  46.  
  47.   11.  Built-in file and directory manipulation, including
  48.        directory display, file display, file copying, file erasure.
  49.  
  50.   12.  Screen dumps to a file.
  51.  
  52.   13.  Customizable modem support.
  53.  
  54.   14.  Automatic change of baud rate to the proper one with
  55.        smart modems like the Hayes 1200 and USR Courier.
  56.  
  57.   15.  Built-in phone area code directory.
  58.  
  59.   16.  Review buffer for lines scrolled off top of screen.
  60.  
  61.   17.  Easy alteration of program parameters to customize to
  62.        a particular system.
  63.  
  64.   18.  Extensive script facility for automating communications chores.
  65.  
  66. Version 3 also fixes a number of problems from earlier versions
  67. of PibTerm.
  68.  
  69. This archive library was created using ARC430.EXE.  I assume that if you
  70. are reading this file, then you have the proper version of ARC!
  71.  
  72.  
  73. CONTENTS
  74. ========
  75.  
  76. This archive should contain 17 files, as follows:
  77.  
  78.      PIBTERM.COM   (Executable files and overlays for PibTerm)
  79.      PIBTERM.000
  80.      PIBTERM.001
  81.      PIBTERM.002
  82.      PIBTERM.003
  83.      PIBTERM.004
  84.      PIBTERM.005
  85.      PIBTERM.006
  86.      PIBTERM.007
  87.  
  88.      PIBTERM.FON   (Sample dialing directory)
  89.      PIBTERM.PRE   (Empty dialing prefix file)
  90.      PIBBW.CNF     (Configuration for monochrome monitor)
  91.      PIBCOLOR.CNF  (Configuration for color monitor)
  92.  
  93.      VT100.FNC     (Key definitions for VT100 keypad keys)
  94.      CDCNOS.FNC    (Key definitions for VT100 under CDC NOS)
  95.  
  96.      PIBTERM3.DOC  (Printable documentation for PibTerm)
  97.      README.DOC    (What you're reading now)
  98.  
  99.  
  100. CHECKING ARCHIVE'S INTEGRITY
  101. ============================
  102.  
  103. After downloading the file PIBTERM3.ARC, it's a good idea to
  104. verify the integrity of that file using the integrity check
  105. feature of ARC430.  To perform the check, enter:
  106.  
  107.      ARC430 T PIBTERM3.ARC
  108.  
  109. If the archive passes the integrity check, then you can proceed
  110. to extract the files as shown below.  If the archive is bad, you
  111. can either try downloading it again (although the file may be
  112. bad on the BBS you called), or write me for the source + executables
  113. disks as described below.
  114.  
  115.  
  116. DOCUMENTATION
  117. =============
  118.  
  119. Full documentation for PibTerm is found in file PIBTERM3.DOC.
  120.  
  121.  
  122. USING PIBTERM
  123. =============
  124.  
  125. To execute PibTerm, extract the files all files from the archive
  126. using the command:
  127.  
  128.    ARC430 E PIBTERM3.ARC *.*
  129.  
  130. Make sure all the files reside in the same directory.
  131. If you have a color monitor and color graphics card, rename the
  132. file PIBCOLOR.CNF to PIBTERM.CNF.  If you have a monochrome
  133. monitor, rename the file PIBBW.CNF to PIBTERM.CNF.
  134.  
  135. Enter PIBTERM in response to the DOS prompt, and away you go!
  136.  
  137. To find out how to execute PibTerm from a different directory,
  138. see pages 6 and 7 of the documentation file PIBTERM3.DOC.
  139.  
  140.  
  141. SOURCE CODE FOR PIBTERM
  142. =======================
  143.  
  144. The source code for Pibterm comprises about 34000+ lines of Turbo
  145. Pascal.  You may be able to find the source archive files PIBTRM3A.ARC
  146. and PIBTRM3B.ARC on the same BBS from which you obtained this executable
  147. version.  If not, then you may get the source by sending $12 to:
  148.  
  149.               Philip R. Burns
  150.               Vogelback Computing Center
  151.               Northwestern University
  152.               2129 Sheridan Road
  153.               Evanston, IL.  60201
  154.  
  155. The $12 is a media, mailing, and handling cost, not a program charge.
  156. You will receive two disks with the complete source in ARC version 4.3
  157. format, as well as the corresponding executables.
  158.  
  159.  
  160. RESTRICTIONS ON USE
  161. ===================
  162.  
  163. You may also make unlimited copies of the program and distribute these
  164. copies as you desire, except that I, Philip R. Burns, reserve the sole right
  165. to distribute the program for profit.  You may request a duplication
  166. charge, not to exceed $10 per copy for the complete executables archive.
  167.  
  168. You should distribute the program without any changes you have made,
  169. and then a SEPARATE version with any changes you've made.
  170. You should clearly mark the changes in some sort of documentation file,
  171. as well as in the source files you change.  I also suggest that you
  172. add a line to the initial output of PibTerm indicating your name and
  173. the date of your modification.
  174.  
  175. You may use the source code and modify it as you please for
  176. NON-COMMERCIAL APPLICATIONS ONLY.  You may NOT use the code in
  177. developing commercial applications without my permission.
  178.  
  179. I encourage you to extend this program and add interesting
  180. new features.  I also encourage you to upload these changes to
  181. your local BBSs in order to share your work with others.  What I
  182. do NOT want is for you to rip off this code as if it were yours
  183. and sell it for a profit.  That's not nice.
  184.  
  185. THE GD= PARAMETER
  186. =================
  187.  
  188. I left out one important piece of information in the documentation.
  189. The configuration parameter GD= specifies the number of hours that
  190. local time lags Greenwich mean time.  This information is used to
  191. adjust the universal time dates received during Ymodem transfers.
  192. For example, Chicago generally lags Greenwich mean time by six hours.
  193. You will need to change this parameter in the file PIBTERM.CNF
  194. using a text editor, since I forgot to allow a menu item for it.
  195.  
  196. ADDRESSES FOR ELECTRONIC LETTER BOMBS
  197. =====================================
  198.  
  199. You may leave me messages on the following BBSs:
  200.  
  201.       Gene Plantz's BBS (312) 882 4145
  202.       Ron Fox's BBS     (312) 940 6496
  203.  
  204. Gene's board is registration only ($15 a year) but well worth it.
  205. Ron's board is essentially open, and also worth calling.
  206.  
  207. Thanks,
  208. Phil Burns
  209. October, 1985
  210.  
  211.